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INTRODUCTION TO GEAP MANUAL 



It should be noticed that this manual is in two parts. The -first 
part acquaints the user with the regular GEAP commands. The 
second part contains the "extra", "advanced", commands associated 
with the GEAP 48K version. 

After learning how to get in and out of the various elementary 
commands, you may wish to read Section (s) 5.0—5.3. This will 
show you an easier method of saving screen drawings. 

"Newscript" users will -find instructions to combine GEAP with 
word-processing at 11.0 in the GEAP/4Sk Manual. 



INSTRUCTIONS FOR 4SK GEAR DISK USERS 

Your GEAP program (s> are distributed on a formatted TRBDOS disk. (If 
you are a Model III owner, you will have to use the CONVERT command). 



SINGLE DRIVE OWNERS 

Due to our respect for copyright laws, we must distribute GEAP on a 
forinatted disk. If you have a friend with two drives, you- might ask 
them to transfer the program (s) to a TRSDOS for you. 

If this option is unavailable to you we offer the following 
alternatives: 

1. Send us a copy of your TRSDOS and we will make the transfer for 
you, or 

2. Request that we send you the program on cassette, or 

3. Send us *13 (in addition to the price of GEAP) and we will send 
you a TRSDOS and GEAP on a copy of the TRSDOS that you are 
purchasing. 

MAKING A BACKUP COPY 

We strongly suggest that you make a backup copy of this disk before 
continuing. 

1. Insert a system disk into drive 0. Insert the GEAP formatted disk 

in drive 1. Now type : BACKUP 

2. Insert a blank disk in drive O. For source disk, specify 1, for 

destination specify O. 

After the backup has been completed, you are now ready to start using 
GEAP. Re-insert your system disk and go to BASIC. Type RUN "GEAR" 
and start reading the instructions in section 1.1. One word of 
caution. DO NOT try to make a copy of GEAP AFTER you have used the 
"RUN- command. A copy made using the "SAVE" command after GEAP has 
been run will not work. If attempting to use this method, use the 
"LOAD" command when in BASIC and then immediately use the "SAVE" 
command. 

PROGRAM NAMES ON YOUR DISK 

The following programs arm on your GEAP disk: 

GEAP Max n Program 

EXPMD1 Expansion Module 1 

EXPMD2 Expansion Module 2 - Med. Letter Set 

EXPMD3 Expansion Module 3 - Large Letter Set 

EXPMDA ......Expansion Module 4 - Cube Letter Set 

EXPMDP1 Expansion Module 3 - Epson MX-BO printer support 

SCRIPMOD NEWSCRIPT Save or Load File Module 



Graphics Editor and Programmer Instruction Manual (GEAP) 

Table of Contents Page 

1 .0 Introduction.. 1 

1.1 Pre I imlnarles 2 

2.0 Elementary Commands - Modes 2 

2.1 Elementary Commands - Regular Mode 2 

2.2 Elementary Commands - Print Mode 3 

2.3 Elementary Commands - Keypad Mode 5 

2.4 Elementary Commands - Designate Mode 6 

2.5 Compressed Code, Non-Compressed Code and Storage Formats 6 

2.6 Long Term and Temporary Storage 7 

3.0 Intermediate Commands - Keypad Mooe 6 

3.1 Designate Mode - Fill In Option 8 

3.2 Designating a Figure 9 

3.3 Moving the Designated Figure 9 

3.4 Menu Options 4-8 9 

3.5 Storage of Designated Figure 10 

3.6 Menu Option 2: Store Figure In Basic String 10 

3.7 INPUT Statements 11 

3.8 Loading Pictures For'Re-Edlttng 12 

4.0 Advanced Commands and Fine Points - Marking Off the Screen 12 

4.1 Merging Pictures 13 

4.2 16K Memory and Storage Overflow 13 

4.3 Delay Loops '3 

4.4 Location 1023 and the Screen Edges 14 

4.5 Menu Options 1 and 2 Compared 14 

4.6 Creating Your Own GEAP Expansion Mocules 14 

Appendix - Merging Two Basic Programs 16 

Summary of Commands 18 



ffS fSl fFai fsfl 



Graphics Editor and Programmer Instruction Manual (GEAP) 



1.0 INTRODUCTION 

GEAP Is a program, written In BASIC, that Is part text editor, pert screen 
drewlng'utl I tty, and part BASIC program creator. 

GEAP has a library of commends that allows you to make Intricate screen 
drawings and formats. When you are finished with your drawing, GEAP can write a 
BASIC program that will reproduce the drawing. This program can be' recorded, 
and then merged with another program or run by Itself. You can specify how the 
program Is written. It can be In compressed code for minimum storage space and 
fastest execution. It can be In non-compressed code for easy editing or 
compiling. Or, you can save part of the screen In String Format for animation 
with PRINT! statements. You can store several drawings and record them all at 
once. 

GEAP' s command library Includes: 

Editing Flashing cursors controlled by arrows allow you to draw and erase using 
single dots, graphics symbols, or alphanumeric symbols. Or, you can construct 
your own "paintbrush". 

Coordinates This command tells you where the cursor Is located on the screen, 
giving X and Y coordinates and PRINTS location. 

Re-edltlng You can load the BASIC progrem created by G E A P tor almost any 
other BASIC program that draws a picture) Into GEAP for re-edltlng. 

Move Entire Screen Move the complete screen Image up, down, left or right. 

Hegnl fy, Rotate, T1 It, Shrink/Expand, Draw Symmetrica l Views You can designate 
part of the screen to be rotated, magnified, etc. 

Fill . In or Reverse Designated Pert of Screen You can drew an out I Ine and have 
the computer ft I t it In with a specified graphics character, or reverse the 
black and white areas within It. The outline doesn't have to be a rectangle. 
It can be Irregular and even have holes In It. 

Store Screen In Memory You can store your drawing In a temporary buffer so that 
you can experiment with changes and still be able to restore the original. 

Kove/ Store Designated Figure You can mark off part of the screen to be moved 
and stored Independently of the rest of the drawing. You can merge this figure 
with a previously stored picture. 

Add INPUT Statements You can allow- for keyboard response when the program 
created by GEAP Is run. A special control character (the quote mark) will cause 
GEAP to Insert INPUT statements In the proper places when It writes your BASIC 
program. 

MERGE TWO DRAWINGS You can oraw a picture and then combine it with a previously 
stored picture. 

Graphics Keypad Graphics symbols ere constructed directly from the keyboard. 
You don't have to know any graphics codes, or even what graphics codes are. 

Expansion Experienced programmers can add their own customized BASIC expansion 
QCdules to GEAP. A special expansion module format allows you to add a tlbrery 
of your o*n symbols, drawings, or subroutines. 
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1.1 PRELIMINARIES 

As wl-h any tool, to get the best usage out of It you will have to spend 
some time learning how to use It properly. The Instruction manual Is dividea 
Into beginning, Intermediate, and advanced sections. Go through each secTion 
and familiarize yourself with the commends. When you feel comfortable with a 
section, move to the next. 

LOADING AND MAKING A BACKUP COPY OF GEAP 

If you are using a Model lit, set your cassette speed to low* To load GEAP, 
prepare your cassette, type in CLOAD and press the ENTER key. (If using disk, 
goto Basic and be sure to use the CVO "T" before loading from casette. After 
GEAP has been placed on disk, you may then use the RUN command). When the 
cassette srops and the READY appears on the screen, check that you have had a 
good load. To do this, type In LIST 32C1 end press the ENTER key. The screen 
should read: 3201 REM22F940C9 

If you want to make a backup copy of GEAP, you should now put a blank tape 
In the recorder, press the Record and Play buttons, type in CSAVE, end press the 
ENTER key. (If you are using disk, use the SAVE command. If you are using 
Stringy Floppy, use the 6SAVE commend.) Meke your copy BEFORE you enter RUN. A 
copy made after you enter RUN will not work. 

This copy Is for your personal use. Please don't give free copies to your 
friends. If they like the program, encourege them to buy their own copy. 

After you've made your copy, type In RLN end press the ENTER key. GEAP'S 
emblem win appear end then a dot will begin to flash. GEAP is now ready for 
your commends. The list of commends begins In the next section. 

IMPORTANT NOTE ; GEAP chenges your memory size setttng as well as some other 
Internal parameters. Reset or reboot your computer before re- loading GEAP or 
any other EASIC programs. 

2.0 ELEMENTARY COMMANDS MODES 

GEAP has four modes. Each mode has Its own set of commands and Its own fleshing 
tndlcetor: 

Reguler Mode flashing dot (.) 

Print Mode flashing asterisk (*) 

Keypad Mode flashing less than (<) 

Designate Mode flashing minus (-) 

2.1 ELEMENTARY COMMANDS IN REGULAR MCDE 

When you CLOAD end RUN GEAP, you will see GEAP'S emblem and then e fleshing 
dot will appear. The flashing dot Indicates that you ere In GEAP's Reguler 
Moce . We will list the elementary commends for the Regular Mode end then 
discuss eecn commend. 

REGULAR MOCE ELEMENTARY COMMANDS 

Arrow fs) Move fleshing dot In indicated direction. Erases as it 

moves. 
'Shift' end Arrow (s) ..Draw line tn Indicated direction. 

'Clear' Cleer the screen 

';' end Enter Record drawing on screen to memory. 

';' and Spaceber Load drewlng stored in memory to screen. 

•9* Cell up menu of further options. 

1 Go to Keypad Mode. 

'-' Go to Cesignete Mode. 

«»' Go to Print Mode. 
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EXAMPLES: 

1) The first thing to do when you see the flashing dot is to hold down the 
various arrow keys and notice how the dot moves.' You may hold down more than 
one arrow at the same time, although for some combinations, such as the up and 
down arrows, the results are not too exciting. 

2) Next, draw a few squlggles by holding down one or more arrows and the 
•Shift' key. 

3) Now erase one of the squlggles. To do this, move the flashing dot over 
the squlggle without holding down the 'Shift' key. 

4) Now let's store the renalnlng squlggles In memory. To do 'this, hold 
down the ';' and 'Enter' keys for a moment. The computer will print "Recording" 
on the screen. Then your picture will return. 

5) Now test that the picture Is really stored In memory. Hit the 'Clear* 
key to clear the screen. Hold down the ';' key and spacebar and your picture 
will return to the screen. The picture will remain stored in memory until you 
record a new one with the •;• and 'Enter' keys. (There Is a rare exception. 
See "16K Memory and Storage Overflow" In the advanced section. If using 
Expansion Modules, also see Expansion module warnings and precautions). 

6) Now let's have the computer write a BASIC program which will reproduce 
the picture on the screen. Hold down the '9' key for a moment and a list of 
options will appear. Choose option 1, "Store screen In PRINT statements", by 
hitting the "I" key. 

7) The computer will tell you the number of bytes available for storing 
your program. This number varies with your memory size, and with the number of 
programs you have already stored. The computer will also tell you the last line 
number It has used. It you haven't stored any programs yet this number will be 
zero. (This number Is reset to zero every time you dump the stored programs. 
See step 11 below.) The computer will ask you for an initial line number. Type 
In a number, say 10, and hit the 'Enter' key. 

8) The computer will ask you If you want compressed code. For now, It 
does not matter whether you hit the 'Y» or 'N' key. Hit either one. 

9) The computer will take a split-second to write the program, and then it 
will print the number of bytes left in storage. If you record the numbers 
before and after your program is stored, you can see how much memory It uses. 

10) Now your picture will reappear on the screen. At this point you may 
be saying to yourself, "I'm supposed to have a program stored somewhere. Where 
In tarnation Is It?" Don't worry. You can look at your program (and record it) 
any time you wish. After you record It, you don't even have to reload GEAP. 
Let's look at It. 

11) Hit the '9' key again to bring back the menu of options. This time 
choose option '3', "Dump Storage", by hitting the "3" key. The computer will 
print "READY FOR RECORDING", and then a second "READY" will appear. Your 
program is now available in memory just as if you had typed It In yourself. To 
test It type In 'RUN' and hit 'ENTER'; your picture will appear just as you 
drew It. If you wish, you may now CSAVE the program on cassette. (Or SAYE it on 
disk, or ISAVE It on Stringy Floppy.) * You may also wish to LIST It. (For 
compressed code the listing will look a little strange.) 

12) You can now reactivate GEAP without reloading. Type In: 

PRINT USRU) : RUN 
and then hit the 'Enter' key. The flashing dot will reappear. 

13) Except for the commands for going to GEAP's other modes,, this 
completes the elementary commands available In GEAP's Regular mode. You might 
want to practice them for awhile and then take a break before going to another 
of GEAP's modes. 

2.2 ELEMENTARY COMMANDS IN PRINT MODE 

The Print Mode Is the simplest of GEAP's modes. To get Into this mode hit 
the key containing the * (asterisk) symbol. If you were in the regular moce, 
the flashing dot wit I be replaced by e flashing * sign. 
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PR I NT HOPE ELEMENTARY COMMANDS 

Arrow Move one space In Indicated direction. 

•Enter' Go to center of current line. 

6 and ArrowCs) Move In Indicated direction to corner or edge of 

screen . 

§ and 'Enter* Move to center of screen. 

'Clear' Go to Keypad Mode. 

'Shift' end Arrow (Model I only) Print picture of arrow. 

(Note: On some Model l" s, you must press 'shift' and 
'down arrow' and then hit 'Z' key to get picture of down 
arrow) 

Any other syrrool Print the symbol pressed and move to the right. 

EXAMPLES: 

1) Type a few symbols, numbers, letters, etc. Now use the arrows to move 
the flashing- * sign over the symbols you've typed. Note that the flashing * 
sign does not erase anything. 

2) Whet If you want to erese a symbol? Use the arrows to move the 
flashing * sign onto the symbol. Then hit the spacebar. 

3) Note that hitting the 'Enter* key moves the flashing * sign to the 
middle of the line. This Is used for centering words, titles, etc. on the 
screen. 

4) Now hold down the € key and then—still hoi o I ng down the § key — press 
an arrow, then release the arrow, and finally, release the 6 key. The flashing 
* sign will reappear at the edge of screen pointed to by the arrow. If you hold 
down two arrows with the i key, the cursor will reappear In the corner pointed to 
by the arrows. If you hold down the 'Enter' key with the 6 key, the cursor will 
reappear In the center of the screen. 

5) In two ways the Print Mode acts differently than the other modes. 
First, In any mode except the Print Mode, hitting the '9' key brings up the menu 
of options. (We've already seen this In the regular mode.) In the Print Mode, 
however, hitting the '9' key merely results in a 9 being printed on the screen. 
Second, you can go from one mode to any mode by hitting the proper key, except 
when In the Print Mode. There Is only one way to get out of the Print Mode. 
You must hit the 'Clear* key to exit. 

6) Hit the 'Clear' key now. The fleshing * sign will be replaced by a 
flashing < (less than) sign. This is the symbol of the Keypad Mode . We will 
discuss the commands available In this mode In a minute, but first, let's test 
the statements In (4) above. 

7) Hit the '9' key. The same list of options that we called up from the 
Regular Mode will appear. This time let's choose the simplest option of ell, 
the "Cancel" option. Hit the '9' key. The picture you had before calling the 
menu will reappear. 

8) Now let's go from the Keypad Mode to the Regular Mode. To do this, hit 
the period key. The fleshing < sign will be replaced by the flashing dot. You 
can try a few of the Regular Mode commands to convince yourself you're back In 
the Regular Mode. 

9) Now let's go from the Regular Mode directly to the Keypad Mode. Hit 
the key containing the < symbol. The flashing < symbol will reappear. 

Let's now examine the Keypad Mode. 
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2.3 ELEMENTARY COMMANDS IN KEYPAD MOPE 

Here Is the list of elementary commands. You may notice something a little 
strange about the 1 1st. 

KEYPAD MODE-ELEMENTARY COMMANDS 

Arrow(s) Move flashing < In Indicated direction. 

■Spacebar 1 ..Draw horizontal line through flashing < sign. 

•Enter* Print flashing < sign's column number, row number, 

and PRINT! location. 

'/' and Arrow Move entire screen In Indicated direction. 

•9' Cell up the menu. 

'.' (period) Go to Regular Mode. 

»*« Go to Print Mode. 

*-' Go to Designate Mode. 

The strange thing about this list Is that it contains no mention of the 
word "keypad". This is because all commands concerning the "keypad" are 
intermediate commands; they will be covered In Secton 3. 

EXAMPLES: 

1) Move the flashing Indicator around the screen with the arrows. Note 
that It moves similarly to the flashing dot, except It flashes at a slower rate. 

2) You may have noticed that It takes a long time to draw a horizontal 
Una across the screen using the Regular Mode. To remedy this, we've included a 
horizontal line command In the Keypad Mode. Just hold down the spacebar, and a 
horizontal line will be drawn through the fleshing < sign. 

3) Now hold down the 'Enter' key. In the upper left corner you will see 
the flashing < sign's column number (X coordinate);' In the middle you will see 
the sign's row number (Y coordinate); In the right corner you'll see the sign's 
PRINTi location (X+64*Y). This command Is useful for getting letters In the 
correct column or row: Just move the < sign to the correct position — checking 
the position with the 'Enter' key — and then hit the ■*• key to get the Print 
Mode; type In the desired letter or word, hit the 'Clear* key to bring back the 
Keypad Mode, move to the next desired location, etc. Or, you may have completed 
a drawing and want to know where to print a variable (with a PRINTe command) 
when the drawing later becomes part of a BASIC program. Just move the flashing 
< sign to the spot where you went the variable to be printed, hit the 'Enter' 
key, and record the PRINT* location for future use. 

4) Now go back to the Regular Mode or the Print Mode, and put some 
squiggles, symbols, letter, etc on the screen. Return to the Keypad Mode. Now 
hold down the '/* (slash) key and an arrow. The entire drawing will move In 
the Indicated direction. Note that you must hold down only one arrow at a time. 
Note also that any part of the picture that moves off the screen edge Is. lost. 
I f you want to move a_ picture close to the screen ed ge. It's a good idea, be fore 
you move It, to go to the Regular Mode and record the screen to memory. That 
way If you lose part of It off the screen edge, you can return to the Regular 
Mode and bring back the original picture by hitting the ';' and the spacebar. 
You can also set your flashing cursor at the right edge of the screen for a 
position marker. 

Except for the command for going to the designate mode, this completes the 
elementary commands for the Keypad Mode. 

To go from the Keypad Mode to the Designate Mode, hit the •-• key. The 
flashing < sign will be replaced by a flashing *-' sign. You are now In the 
lest of the four modes, the Ceslgnate Mode. 
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2.4 ELEMENTARY COMMANDS IN THE DESIGNATE MCCE 

The purpose of the Designate Mode ts to mark off part of your drawing so 
you can operate on Just the marked oft pert while leaving the rest of the 
drawing atone. 

D ESIGNATE MODE - ELEMENTARY CCWANDS 
ArrowCs) ~ Move flashing '-' sign In Indicated direction. Does not 

erase as It moves. 
•Shift* and ArrowCs) ..Mark location with e '+' sign and move In Indicated 

direction. 
•Enter' Record the part of the screen marked off by • + ' signs and 

bring up new list of options. 

'Clear' Erase ' + ' signs and start over again to mark off screen. 

•9* Call up the usual menu of options. 

'<' Go to the Keypad Mode. 

'.' (period) Go to the Regular Mode. 

•*• Go to the Print Mode. 

EXAMPLE: 

Let's go through an example of marking off a part of the screen. 

1) If you don't already have lots of squlggles on the screen, go to the 
Regular Mode (by hitting the period key) and draw a lot of squlggles. Then 
return to the Designate Mode by hitting the '-' key. 

2) Now let's mark off a rectangular part of the screen to operate on. 
Choose an Imaginary rectangle on the screen so that some of your squlggles are 
Inside and some are outside. Mark It off as follows: use the arrows to move 
the flashing '-' sign to one corner of the rectangle. Now use the 'Shift 1 key 
and an arrow to leave a '+' sign at the corner. (If you hold down the 'Shift' 
key too long, you may leave additional *+' signs on the screen. That's OK, 
don't worry about It.) Now move the flashing '-' sign to the diagonally 
opposite corner of the rectangle. If the first *+' sign was In the upper left 
corner, for example, then you now move to the lower right corner. Use the 
'Shift' key end an arrow to leave a '+' slcn in that corner. Now, move the 
flashing '-' sign anywhere Inside the rectangle, just so It's not resting on a 
'+' sign. Hit the 'Enter' key. This completes marking off the rectangle. 

3) When you hit the 'Enter' key, the screen will flesh, and you'll be 
given a list of 5 options: 

1 -DESIGNATE, 2-FILL IN.-3-REVERSE. 4-MERGE, 5* CANCEL 
Choose option 3, "Reverse", by hitting the '3' key. Your picture will return to 
the screen, but the black and white parts of the rectangle that you marked off 
will be reversed. (Letters end other non-graphics symbols will, however, be 
unchanged.) 

4) We've covered a lot (at least J_ think so) and so we'll save the other 
options, "Designate", "Fill In", and "Merge" for later sections. (The "Cancel" 
we leave to the reader to investigate.) in a later section we'll also describe 
how to mark off figures more complicated that rectangles. 

This completes the description of the elementary commands. You might want 
to practice with these for awhile, making pictures, for example, that contain 
squlggles drawn In the Regular Mooe, letters entered In the Print Mode/ and 
rectangles with black end white reversed, ell In the seme picture. Then you 
might want to save the picture In PRINT statements with option 1 of the menu.. 

2.5 COMPRESSED CODE, NON-COMPRESSED CODE AND STORAGE FORMATS 

You might save a picture In both compressed code format, end non-compressed 
format, end compare the two. You'll fine that compressed code usually uses 
fewer bytes than non-compresseo cocie. Non-compressed code, en the other hand, 
can be edited with the regular BASIC editing cormends. If you plan to make the 
picture part of a long BASIC program and mey later went to change It a little 
bit, then It's best to save It In non-compressed code. Also, you may want to 
run the program through a compiler, enc r^eny compilers don't allow the 
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compressed code format. 

If you store several pictures and record them all at once, how do you tell 
where one ends and the next begins? If you RUN them, the pictures will appear 
In rapid succession, and only the lest will stay on the screen. Each picture, 
however, ends with a line that says REM END DUMP. The line number of the REM 
END DUMP Is printed with the message LAST LINE NUMBER USED when you eel I option 
1 of the menu. If you write down these line numbers then you will know where 
each picture ends. If you went the pictures to remain longer on the screen when 
you run them, replace each REM END DUMP line with a line like: FOR I - 1 TO 999 
: NEXT which will cause a delay of 599 counts after each picture. 

Sometimes the Basic READY message will cause part of your picture to scroll 
upward off the screen. To fix this, replace the line that says REM END DUMP 
with a line of the form *nnnn GOTO nnnn». For example If the last line In your 
picture-drawing program Is 50 REM LSD DUMP, then type In 50 GOTO 50, and hit 
'Enter.' Now RUN the program. The picture will remain on the screen until you 
hit the BREAK key. 

A final word of caution. Don't use option 1 to store a picture that 
contains a "(quote) mark. Extra quote marks confuse PRINT statements. In 
fact, we've rigged GEAP so that it treats quote marks as special control 
characters. More about this in section 3.7 

2.6 LONG TERM AND TEMPORARY STORAGE 

Recall that you can put a picture In long term storage by going to the 
Regular Mode and hitting the ' j' end ENTER keys. You can bring It back by going 
to the Regular Mode and hitting the ';' and spacebar. Now suppose you want to 
bring beck the stored picture, but you don't want to lose the picture currently 
on the screen. Well, GEAP has another, temporary, storage area. A picture Is 
placed In temporary storage when, for example, you call up the menu of options. 
And you can bring back a picture from temporary storage by going to the Regular 
Mode, holding down the SHIFT key, and then hitting the spacebar. 

So we've sneaked In one extra' command for the Regular Mode: 

Shift and Spacebar Load temporary storage to screen 

To bring back a picture from long term storage without losing the picture 
currently on the screen, you can: 

1) Go to the Regular Mode by hitting the 'period' key. 

2) Cell up the menu_by hitting the '9' key. Choose the Cancel option by 
hitting the '9' key again. The current picture Is now In temporary storage. 

3) Bring up the picture from long term storage by hitting the ';' and 
spacebar. 

4) When you have finished looking at this picture, restore the current 
picture by holding down the SHIFT key and hitting the spacebar. 

In section 4.1 we will see hew to merge a picture In temporary storage with 
a picture In long term storage. 

3.0 INTERMEDIATE COMMANDS _IN KEYPAD MODE 

First, let's describe the graphics keypad , which Is used, logically enough, 
in the Keypad Mode. The graphics keypad Is the six keys on the left side of 

the keyboard: GW 

AS 
ZX 

When you're In the Keypad Mode, hitting one of these keys turns on a dot to the 
left of the flashing < sign. Eech key turns on a different dot. To see how 
this works, clear the screen (I.e. go to the Regular Mode and hit the 'Clear* 
key), then go to the Keypad Mode, end use the arrows to move the flashing < sign 
near the center of the screen. 
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Now hit the 'Q* key and notice which dot Is turned on, then hit the 'A 1 
key, then the «Z' key, then 'W', «S', and 'X'. 

Sow let's use the graphics keypad to erase dots. To do this, hold down the 
'Shirr* key end hit one of the letters In the graphics keypad. The dot In the 
posiTion corresponding to the letter you hit will be erased. 

Sow move the flashing < sign to a new position on the screen, and use the 
keypad to turn on some combination of dots. Now, hold down the 'Shift* key and 
one or more arrows. The flashing < sign will move In the indicated direction 
end leave e trail of symbols just like the one you entered using the graphics 
keypad. This symbol will remain in memory until you hit one of the letters In 
the keypad egaln. 

You might practice using the keypad for e while, entering various 
combinations of dots, and then drawing pictures using the 'Shift' and arrow 
keys. Note one tricky point: when you hit one of the keypad letters, the 
corresponding dot Is combined with the dots already on the screen. The symbol 
that's stored In memory Is the entire six dot postlons to the left of the 
flashing < sign. For example, suppose the flashing ( sign Is "pointing to" a 
completely blank space, and suppose you hold down the 'Shift' key and hit the 
letter 'Q'. Then the symbol storeo In memory is blank In all six dot positions, 
not just the position (upper left) corresponding to the letter 'Q'. Also note, 
however, that to store a symbol In memory — so that you can use It to draw with 
— you must hit at least one keypad letter. It does no good to merely point the 
flashing < sign at the symbol; nothing Is stored in memory until you hit the 
first keypad letter. 

This completes the list of commands available in the keypad Mode. 
Summarizing the additional commands: 

KEYPAD MODE INTERMEDIATE COMMANDS 

QW 

One of these: AS Turn on corresponding dot to left of flashing < 

ZX sign 

QW 

•Shift' end one of AS Erase corresponding dot to left of 

ZX flashing < sign 

•Shirr' end ArrowCs) Move In Indicated direction and leave a trail of 

symbols like the one last entered with 
graphics keypad. 

3.1 DESIGNATE MODE FILL \H OPTION 

in Section 2.4 we sew how to mark off a rectangle and reverse the black and 
white areas Inside. Now let's see how to till In a rectangle with a specified 
graphics symbol . 

1 ) Go to the Designate Mode by hitting the '-» key. Mark off a rectangle 
as aefore, that Is, place '+• signs In diagonally opposite corners of the 
rectengle, move the flashing '-* Inside, and hit the 'Enter* key. 

2) When the five options appear, choose option 2, "Fill In", by hitting 
the »2' key. 

3) The computer will ask you to enter the desired graphics symbol. How do 
you co that? With the graphics keypad. As an example, hit the '0* key, then 
the *A* key, then the •X' key. Note that the symbol Is pictured between the > 
end < signs. 

A) When you've got the symbol you want, hit the 'Enter' key. The computer 
will then fill In the marked off rectangle with the symbol you entered. 
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3.2 DESIGNATING A FIGURE 

Now let's consider option 1, the "Designate" option. In page one, we 
claimed that we could magnify figures, rotate figures, shrink them, etc. How do 
we tell the computer which figure to use? We make a designated figure . Here 
are the steps In designating a figure. 

1) Draw the figure If it's not already on the screen somewhere. (If you're 
trying this for the first time, make It a smal I figure.) 

2) Go to the Designate Mode. 

3) Use the arrows to move the fleshing '-' onto the figure. 

4) Use the 'Shift' key and the arrows to cover the entire figure with '+' 
signs. 

5) Leave the flashing '-' sign en one of the '+* signs. Hit 'Enter*. 

6) When the list of options appears, choose option 1 by hitting the ' 1' 
key. The computer will ask you If you want to see the figure's graphics codes. 
tf you know what graphics codes ere, end you want to see them, hit the *Y' key. 
Otherwise hit any other key. (Note that you may use the graphics codes to 
manually construct a string.) 

7) The picture will new reappear on the screen. The part of the screen 
that you covered with '+' signs Is now the designated figure. 

To move the designated figure go to the Regular Mode. 

3.3 MOVING THE DESIGNATED FIGURE 

REGULAR MODE - INTERMEDIATE COMMANDS FOR DESIGNATED FIGURE 
•/• and ArrowTsTT Move figure in indicated direction. 

V and 'Clear' Erase designated figure. 

V and 'Spacebar* load designated figure to screen. 

'/• and 'Shift' and Arrow (s).. Draw, with designated figure as a "paintbrush". 

EXAMPLES: 
1) When you've gone to the Regular Mode (by hitting the 
period key), move the designated figure around the screen by holding 
down the '/' key and one or more arrows. 

.2) Now we'll make a duplicate of the designated figure. Record the screen 
to memory (by hitting the ';• and 'Enter 1 key). This will save the designated 
figure in Its current position. Now move the designated figure to a new 
location. Load memory back to the screen (by hitting the ';' and spacebar). 
This will bring back the figure to the old location, but will erase the figure 
at the new location. Load the figure back at the new location by holding down 
the '/' key and hitting the spacebar. Now you've got two copies of the 
designated figure on the screen. You can make a third copy by recording the 
screen again, moving the figure to a new location, etc. You can erase a copy by 
using the '/* and 'Clear* keys. 

3) To paint the screen, with the designated figure as a paintbrush, hold 
down the '/' and 'Shift* keys along with one or more arrows. Painting the 
screen In this way and then reversing black-white in various rectangles can give 
you some very Interesting pictures. 

Let's continue operating on the designated figure by going to the, menu of 
options. 

3.4 MENU OPTIONS 4 THROUGH 6 

4) Let's magnify the designated figure. To do this, bring up the menu of 
options by hitting the '9' key, and then choose option 4 by hitting the '4* key. 
The computer will magnify the designated figure by a factor of 4. The magnified 
figure will not be centered on the screen, but you can center It by going to the 
Keypad Mode and using the V end tne arrows. 

5) Tilt the designated figure by going to the menu and choosing option 3. 

6) Now go to the menu end choose opt i en 6, "Four views of Figure". This 
option Is useful for avoiding lopsided figures. You can draw just half the 
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Intended figure, make this half the designated figure, and then let the computer 
drew the other half with option 6. Then move the designated figure over next to 
the view that represents the other half of the figure you want, end make a new 
designated figure out of the two halves. 

7) Now go to the menu and try cptlon 7, "Rotate Figure". You enter the 
rotation angle and then the computer asks ycu If ycu want the figure magnified. 
Hit the *Y' key to get magnification end any other key for no magnification. 
The proportions of the magnified figure are usually more accurate than those of 
the non-magnl f led figure. 

8) Now try option 8 of the r.enu, "Shrink/Pull -Apart Figure". You must 
enter a shrink/expand number for the X-dlrectlon and for Y-dlrectlon. Numbers 
less than one, .5 for example, shrink the figure. Numbers greater than one, 2 
for example, expand It. 

3.5 STORAGE OF DESIGNATED F1GIRE 

Before going to the remaining option (option 2), let's make a couple cf 
observations about the way the designated figure Is stored. First, since the 
designated figure Is stored as a BASIC string. It can't be longer than 255 
bytes. If you try to designate a figure that takes more than 255 bytes to 
store, the computer will use only the first 255 bytes of the figure. (The 
computer will give you a warning message about this, of course.) Second, the 
figure Is stored using both graphics codes and control codes. This allows for 
efficient storage. To see what this means try the following: 

1) Go to the Regular mode end put a dot In the upper left corner of the 
screen . 

2) Move the flashing dot to trie bottom row and leave another dot In the 
lewer left corner of the screen, so that the bottom dot Is lined up with the top 
dot. (The quickest way, Incidentally, to get from the top row to the bottom row 
Is to use the up arrow; the fleshing dot will move off the top line and reappear 
on the bottom line.) 

3) Now make a designated figjre out of the two dots. It will, of course, 
"take two '+' signs to cover the two dots. (Don't forget to leave the flashing 
*-' sign on one of the two • + ' signs when you hit 'Enter'.) 

4) Now go to the Regular Mode end drew a squlggle somewhere near the center 
of the screen. 

5) Now move the designated figure to the right with the '/• key and the 
right arrow. 

6) Here's the point of the demonstration. As the designated figure lines 
up with the squlggle In the middle of the screen, the squlggle will not be 
erased. The computer prints no blanks when It moves from printing the top dot 
of the designated figure to printing the bottom dot of the designated figure. 
The figure's control codes move the cursor without erasing. 

( I nc I cental ly. If you continue to neve the cesignated figure until It 
touches the lower right corner of the screen then the screen will scroll upward. 
See "Location 1023" In the final section.) 

3.6 MENU OPTION 2j_ STORE FIGURE IN BASIC STRING 

Menu option 2 Is used to store the designateo figure so you can record" It 
on tape, disk, or Stringy FIcppy. Here's the procedure In the form of an 
EXAMPLE: 

1) Hit the '9' key to bring up the menu, and cheese option 2, "Store Figure 
In BASIC String", by hitting the '2' key. 

2) The computer will ask you for a star-ring line number. Enter say, 10. 

3) The computer will ask ycu fer a nere for the figure. Enter say, N$. 

4) The computer will ask you fer a nere for the string that will erase the 
figure. Enter say, ENS. 

10 
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5) Your picture will reappear on the screen. Now let's examine the stored 
figure. To do this, call the menu again, and choose option 3. 

6) When the "Ready for Recording" message appears, the two strings are in 
memory as BASIC strings, the figure NS on line 10, and the erasing string ENS on 
line 20. (Sometimes a figure Is too big to store on one line. If the figure 
uses close to 255 bytes. It takes two lines to store and the erasing string also 
takes two lines to store.) 

7) If you tried to LIST lines 10 and 20, they looked rather strange. They 
are stored In compressed form which, unfortunately, doesn't list very well. 
(The non-compressed form of the designated figure can be seen when you first 
define the figure: hit 'Y 1 when the computer asks If you want to see the 
figure's graphics codes.) 

8) Let's add some lines to lines 10 and 20 so we get a BASIC program that 
will print the figure NS and then erase It. Don't worry about the feet that 
GEAP is still In memory. Type In the lines: 

5 CLEAR 100 

100 CLS: PRINTS 30 , NS ; 
110 FOR I - t TO 2000 : NEXT 
120 PRINT* 30 , ENS ; 

Line 5 will clear string space for the strings In 10 and 20. Line 1C0 will 
clear the screen and then print the figure NS at location 30. (Don't forget the 
semi-colon at the end of line 100.) Line 110 will cause a delay so you can 
examine the figure. Line 120 will erase the figure by printing the erasing 
string ENS at location 30. 

9) Now type In 'RUN 1 and hit 'ENTER'. The program will be executed. 
(Note: If you didn't clear enough string space In line 5, you'll get an OS 
error. If you get this error, change line 5 to clear more string space.) You 
can record this little program If you wish. 

10) You can reactivate GEAP by typing In 

CLEAR I : PRINT USRU) : RUN 
and then hitting 'ENTER 1 . (Note: The 'CLEAR 1* is necessary only when you've 
run a program that contains a CLEAR statement, as line 5 above does. Otherwise, 
you can Just enter, PRINT USRU) : RUN ) 

A final word of caution about storing a designated figure. Don't store a 
designated figure that contains a " (quote) mark. If you do, BASIC will give 
you an error message when It tries to read the string defining the figure. 

3.7 INPUT STATEMENTS 

Since we can't store quote marks, what do we use them for? We use them is 
a signal to Insert INPUT statements. Suppose you go to the Print Mode, end type 
In : 

ENTER YOUR NAME » 

Now suppose you store the screen In PRINT statements with option 1 of the 
menu. Assuming you used non-compressed code, the screen text would be stored 
as: 

io as 

20 PRINT "ENTER YOUR NAME"; 

30 INPUT AS 

40 REM END DUMP 

In the place where the quote mark occured, the computer Inserted the line 
"INPUT AS". When you are storing the screen with option 1, the computer will 
Insert an INPUT statement each time It comes to a quote mark. The variable 
following the INPUT statement will be whatever name you type in right after the 
quote mark; If you leave a blank after the quote mark, the variable will be AS. 
For example. If the screen says: 
ENTER NAME "NS 
ENTER ADDRESS "ADS 

Then the stored program will be tin non-compressed form) 

II 
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10 CLS 

20 PRINT"ENTER NAME "; 

30 INPUT NS 

40 PRiNT'ENTER ADDRESS"; 

50 INPUT ADS 

60 REM END DUMP 

(NOTE: Since executing an INPUT statement causes a jump to the beginning 
of the next line (after you hit 'ENTER 1 ), you should use only one quote mark per 
line. Extra quote marks on the same line will be Ignored.) 

3.8 LOADING PICTURES FOR RE- ED I TING 

You may want to do more work on a previously saved picture. Or, you might 
have some BASIC program that creates a picture that you would like to edit using 
GEAP. You can load a picture Into GEAP as follows: 

1) Load and RUN GEAP. 

2) When the flashing dot appears, call up the menu and choose option 3 by 
hitting the '3* key. 

3) When the "Ready, for Recording" message appears, load the picture 
creating program (I.e. CL0AD from cassette, LOAD from disk or §L0AD from Stringy 
Floppy). 

4) Add the following line after the statements that print the picture. 
(Say, the last print statement was on line 9C.) 

91 CLEAR 1 : PRINT USR(l) : PRINT USR(4) : RUN 

5) Now enter 'RUN'. The print statements will put the picture on the 
screen and then line 91 will be executed. Line 91 will cause the screen to be 
stored in GEAP 's memory and will activate GEAP. 

6) When GEAP's flashing dot appears, hold down the 'Shift' key and then hit 
the spacebar. You picture will appear, ready for editing. 

NOTE: You cannot load a BASIC picture drawing program Into GEAP If the picture 
drawing prcgrem uses the USR () command. 

4.0 ADVANCED COMMANDS AND FINE FOINTS - MARKING OFF THE SCREEN 

We've seen that we can mark off a rectangle and fill It In, or reverse 
black-white within It. We've also seen how to designate e figure by covering it 
with '+• signs. These options can be swapped. That Is, we can mark off a 
rectangle In the usual way, end then make the rectangle the designated figure by 
choosing option 1, the "Designate" option. (The rectangle must be a small one,, 
of course, since a designated figure can use at most 255 bytes.) We can also, 
cover part of the screen with •+' signs, leave the flashing Indicator on a '+' 
sign, hit 'Enter*, and then choose option 2, "Fill In", or option 3, "Reverse". 

There is a third method of marking off part of the screen. We can cover 
the boundary of a figure with •+• signs, move the flashing '-' sign inside the 
boundary, end hit 'Enter'. The boundary dees not have to be rectangular. It 
does not even have to consist of a single piece. For example, suppose we use 
the 'Shift* and arrows to draw a very large square of '+' signs. Now suppose we 
move the flashing '-' sign Inside the large square, and use the 'Shift* and 
arrow keys to draw a small square of '+' signs Inside the large square. Now we 
move the fleshing •-' sign so that It's outside the small square, but still 
Inside the large square. Now we hit 'Enter' and choose option 3, the "Reverse" 
option. The figure within which black-white Is reversed consists of the large 
square with a "hole" punched out where we drew the small square. The part of 
the picture Inside the small square Is left elene. 

Or we might outline a giant 'L' shape with '+' signs, move the flashing '-' 
sign Inside the 'L' r hit 'Enter', and choose option 2 to fill In the 'L' with a 

graphics symbol . 

There Is, however, one restriction on an outline. The outline must consist 
of horizontal ana vertical segments; no e'legenet segments ere allowed. Note, 
though, that diagonal segments can be approximated by a "staircase" of 
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horizontal and vertical segments (I.e. "over", then down, then over, then down, 
etc). 

The best way to learn thts third method of marking off the screen Is to 
experiment. Draw outlines of many different shapes and see which ones the 
computer wtl I f 1 1 I In. 

4.1 MERGING PICTURES 

Now let's deal- with the remaining option for the Designate Mode, the 
"Merge" option. To merge two pictures proceed as follows: 

1) Draw (or load as In section 3.8) the first picture and record It to 
long term storage by going to the Regular Mode and hitting the ' ;' and ENTER 
keys. 

2) Get the second picture on the screen. You can draw It or load It; you 
can use any of GEAP'S commands (except, of course, save screen to memory — you 
don't want to erase the first picture). 

3) When the second picture Is drawn, save the screen to temporary storage. 
To do this, simply call up the menu of options, which will automatically save 
the screen, and then choose option 9, the cancel option. 

4) Check the positioning of the two pictures. To do this, go to the 
Regular Mode and hit the ';' end the spacebar. This will restore the first 
picture so you can look at It. Bring back the second picture by holding down 
the SHIFT key and hitting the spacebar. 

5) If the second picture Is not positioned correctly, move It by going to 
the Keypad Mode and using the '/' and arrow keys. When you think It's ready, 
check again as In steps 3 and 4. 

6) When the second picture Is positioned correctly, go to the Designate 
Mode, and mark off the area of the second picture that you want to Insert Into 
the first picture. Mark off the area as If you. were going to fill It In, 
except: 

7) when you hit ENTER and get the options, choose option 4, the "Merge" 
option. 

8) The computer will combine the part of the first picture that Is outside 
the marked off area with the part of the second picture that Is Inside the 
marked off area. 

9) The first picture will remain In long term storage. The merged picture 
will be on the screen and a I so in temporary storage ^ 

4.2 16K MEMORY AND STORAGE OVERFLOW 

If you ere using 16K memory, and have stored several pictures In PRINT 
statements, you may get the message "Recording . . . Using Reserve Storage" when 
you save the screen to memory with the 'Enter* key. This means that there's not 
enough room to save the screen In the usual buffer. The screen Is saved Instead 
to a temporary buffer. The temporary buffer is used by other commands (moving 
the entire screen for example). If you use one of these other commands, It will 
erase your stored picture. 

Also, If you save too many pictures and figures, the storage area will 
overflow. In most cases, the computer will print "Storage Overflow ... Dump 
Storage". You can salvage most of the storage as follows. Enter 'PRINT USR 
(4)'. Now CSAVE the storage area (or 6SAYE with Stringy Floppy). The- last 
picture will be cut off at the point where It overflowed, but all previous 
pictures and figures will be Intact. You can then reactivate GEAP as usual by 
entering 'PRINT USR(4) : RUN'. 

4.3 DELAY LOOPS 

You may want to write a program that will print only part of a picture and 
then delay for a number of counts before printing the rest. To do this using 
GEAP, draw the complete picture, then go to the line where you want the delay to 

13 
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start. Put a "(quote) nark In the last column (column 63) of the line. Then 
store the picture with option 1 of the menu. Where the quote mark occured, 
GEAP will Insert an INPUT AS line. Assume the line number was 50. Then 
replace line 50 with the line: 

50 PRINT : FOR M TO 999 : NEXT 

When you RUN the program, line 50 will cause a delay of 999 counts before 
printing the rest of the picture. 

4. 4 LOCATION 1023 AND THE SCREEN EDGES 

If you print a symbol, using a BASIC PRINTS statement. In the last column 
of a line, then BASIC automatically sends the cursor to the beginning of the 
next line. Also, If you PRINT a symbol In the lower right corner of the screen 
(location 1023), then BASIC will make the screen scroll upward. These two facts 
limit the places where the designated figure can be printed. If part of the 
designated figure touches the edge of the screen, the figure will break up. If 
pert of the figure touches the lower right corner, the screen will suddenly 
start roiling upward. If one of these effects happens, move the figure back 
toward the center of the screen. 

We've also rigged GEAP so the flashing cursors cannot wander Into location 
1023. This may cause a problem, for example. If you want to "reverse" the whole 
screen. How do you mark off a rectangle consisting of the whole screen? You 
put '+' signs In the upper right and lower left corners. That will do the 
tr I ck . 

4.5 MENU OPTIONS J. AND 2 COMPARED 

With opt!on~1 you~"always save the entire screen. With option 2, you can 
save at most 255 bytes of the screen. Since the designated figure usually 
Includes control codes, which take storage space, you usually are limited to less 
than 255 bytes of the screen. 

No preliminary operations are required to use option 1. Option 2, on the 
other hand, requires you to designate a figure beforehand. 

To see a picture stored by option 1, you just enter 'RUN'. To see a figure 
stored by option 2, you must add you own PRINT § commands. 

The picture stored by option 1 always appears In the seme location; you 
cen't move It across the screen. The figure stored by option 2, on the other 
hand, can be moved around on the screen by using the PRINT t command with 
different locations following the £ sign. 

A program created by option 1 ends with a line that says: REM END DUMP 

A program created by option 2 consists of a string defining the designated 
figure and a string defining the erasing figure. There Is no special message at 
the end. 

4.6 CREATING YOUR OWN GEAP EXPANSION MODULES 

Perhaps GEAP does not have the command you are looking for. Perhaps you've 
thought of a command you'd like to add to GEAP. Well, GEAP allows for 
expansion. You can add your own customized modules to GEAP. 

A GEAP expansion module has a three part format. The first part is .the 
"string reset". The string reset consists of three lines: 

1962 PRINT USR(4) : CLEAR 1 

1965 XJ-B00 : PRINT USR(21 ) 

1970 CLEAR 200 : GOSUB 1952 
These three lines are always the seme except for the amount of string space 
cleared in line 1970, and the value of the variable X% In line 1965. The 
variable X% In line 1965 Is set equal to the amount of storage space you think 
you neec for alt variables. It should be at least 600 more than the amount of 
string space you decide to clear In line 1970. Note that GEAP by ltsetf needs 
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about 100 bytes of string spec*, and about 700 bytes of space for all variables. 

After the string reset comes the "Initialization" section. In this section 
you Initialize the variables you want to use. (We'll give an example below.) 
The only requirements for this section are that no line number Is higher than 
4999, and that the last command In the section Is GOTO 61. 

The final section is the "action" section. This section always begins with 
line number 5000, and It always ends with line number 10001. The section 
consists of a subroutine. The subroutine Is called from GEAP's Designate Mode. 
When an expansion module Is present, and GEAP Is In the Designate Mode, GEAP 
will scan the keyboard looking for the usual commands; If none of the usual 
commands are received, GEAP will execute a GOSUB 5000, and run through whatever 
subroutine you've Inserted. 

We'll give an example and show how to adjoin expansion modules to GEAP In a 
minute. First, however, we'll list some Information about variables and 
subroutines that GEAP uses: 

1) Variables beginning with A-H are string variables. GEAP does not use 
any variable beginning with the letter C. 

2) The designated figure Is variable F. The string that erases F Is 
Variable E. 

3) Variables beginning with l-Y are Integer variables. GEAP does not use 
any variable whose second symbol Is a number higher than 3. GEAP does not use 
the variable K4, for example. 

4) The variable A Is a temporary storage variable. The variable I Is a 
loop counter. 

5) The subroutine USRlt) stores the screen In a temporary buffer. The 
subroutine USR(0) loads the temporary buffer beck to the screen. 

Here's an example of an expansion module. This module stores designated 
figures In a string array. The current designated figure Is stored by going to 
the Designate Mode and hitting the 'T' key. The computer stores the figure end 
prints out Its array number. The figure can then be printed on the screen by 
going to the Designate Mode, moving the flashing cursor to the desired spot, and 
hitting the figure's array number. Up to B different figures may be stored In 
the array. 

1962 PRINT USRU) : CLEAR 1 

1965 XJ- 1600 : PRINT USR(21 ) 

1970 CLEAR 1000 : GOSUB 1952 

1980 DIM CC8) : K4-1 :CLS 

1990 GOTO 61 

5000 A-INKEYS 

5010 IF VAL ( A ) ) THEN PRINT C( VAL(A) ); 

5020 IF A«"T" THEN C(K4)-F : l-USR(l) : CLS : 

PRINT "STORING FIGURE NUMEER"; K4 : FCR 1-1 TO 999 : 
NEXT : 1 - USR(0) : K4 - K4 +1 : IF M>8 THEN K4 ■ 1 

10001 RETURN 

Lines 1962-1970 are the string reset lines. We clear 1000 bytes of string space 
for the array C ( ). This might not be enough If we try to store 8 large 
figures. Lines 1980-1990 are the Initial tzatlon section. We dimension the 
array C, and set the Index* variable K4 equal to 1. Line 1990 transfers back to 
the main GEAP program. Lines 5000-10001 are the action section. Line 5000 Is 
called from the Designate Mode; the line records which key was hit. Line 501C 
checks to see If a number key was hit, and If one was, prints the string 
corresponding to that number. Line 5020 checks to see If the 'T' key was hit. 
If It was, then the current designated figure F Is stored In the array, the 
screen Is saved, the message Is printed, the screen Is restored, end the array 
Index Is updated. Line 1CC01 returns to the Designate Mode. 



15 
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We adjoin expansion nodules, such as the one above, to GEAP as follows: 

1 ) Load and RUN GEAP 

2) When the flashing dot appears, call up the menu and choose option 3. 

3) When the "Ready for Recording" message appears, enter 'NEW*. 

4) Type In the expansion module. (Or, If it's already stored on tape, 
disk, or Stringy Floppy, load It In.) 

5) Enter 'RUN'. 

When the flashing dot reappears, GEAP Is ready with Its usual commends 

plus those added by the expansion module. The module will remain adjoined to 

GEAP as long as GEAP Itself Is In memory. You can, for example, store a 
picture, record It, and reactivate GEAP as usual. 

You can create a standard library of figures with an expansion module. You 
can store large letters, your firm's logo, often-used sentences, etc. 

EXAMPLE: Suppose you want to have the sentence "Your check is In the 
mall.", always available so G E A P will print It with a single keystroke. 
Proceed as follows: 

1) Load and RUN GEAP. 

2) Write the sentence, "Your check Is in the mail." on the screen and make 
It the designated figure. 

3) Call up the menu and store the sentence In a BASIC string with option 
2. For the line number choose 1980, end for the name of the string choose C. 

4) Call up the menu and choose option 3. 

5) When the "Ready for Recording" messcge appears, your sentence will be 
In memory on line 1980, and the erasing string on line 1990. 

You aren't going to need the erasing string, so delete line 1990. 

6) Type In the I Ines: 

1962 PRINT USR(4):CLEAR 1 

1965 XW50 : PRINT USRC213 

1970 CLEAR 150 : GOSUB 1952 

(1980 O"Y0UR CHECK IS IN THE MAIL" ) already In memory. 

1990 CLS : GOTO 61 

5000 A-INKEYS 

5010 IF A - "M" THEN PRINT C; 

10001 RETURN 

7) You may want to record the expansion module at this point so you won't 
have to retype it if you should want to use It In the future. 

8) Enter 'RUN'. 

When the flashing dot appears, you may print your sentence whenever you 
want to by going to the Designate Mode, moving the flashing '-' sign to the 
desired spot, end hitting the 'M' key. 

Of course, Instead of storing just one sentence, you could store several 
sentences or figures, and make each one correspond to a different keyboard 
letter. 

APPENDIX - Merging Two BASIC Programs 

The picture drawing programs that are created by GEAP can be combined- with 
a program of your own, and the pictures can be called as subroutines. Each 
picture ends with a line that says 'REM END DUMP' . Replace each of these lines 
with a line saying 'RETURN'. Then, at the points In your program where you want 
a picture printed, simply Insert the command GOSUB X, where X Is the picture's 
Initial line number. 

16K PROCEDURE FOR MERGING PROGRAMS 

1) Check that the line numbers In the second program are higher than those 
In the first program. 

2) Load the first program. 
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3) Enter 'POKE 16548, PEEK (16633)-2 : POKE 16549, PEEK (16634)'. If you 
don't get an FC error, go to step 4. If Y ou <*° S°+ an FC error, enter; POKE 
16548, PEEK (16633)+254 : POKE 16549, PEEK (16634J-1 and go to step 4. 

4) Load the second program. 

5) (For the Model I,) Enter 'POKE 16548, 233 : POKE 16549, 66' 
(For the Model III,) Enter 'Poke 16548, 233 t POKE 16549, 67* 

Your two programs have now been combined Into one. 

PROCEDURE FOR DISK BASIC USERS 

If you used the compressed format selection, you may not be able to use 
the MERGE command If trying to combine two BASIC programs created In different 
sessions.- The reason Is that the MERGE option requires that you save the 
program to be merged In ASCII format. Programs that used the compressed form or 
strings created with GEAP may not be saved as ASCII files. 

If you are using Disk Basic, you can combine two programs with the help of 
GEAP. Proceed as follows: 

1) Check that the line numbers In the second program are higher than those 
In the first program. Also, check that the first line number of the first 
program is greater than 1, and that the last line number of the first program Is 
less than 10001. 

2) LOAD and RIM GEAP. When the flashing dot appears, hit the 'BREAK' key. 

3) LOAD the first program. 

4) Enter PRINT PEEK (16548), PEEK (16549) . Copy the two numbers that 
ere printed. (These numbers will vary depending on the number of files open, 
whether you are using BASIC or BASICR, etc., but should remain constant for a 
given configuration you use all of the time.) 

5) Type In the following two lines: 
1 GOTO 10001 

10001 PRINT USR(21) : PRINT U5R(2) : PRINT USR(4) 

6) Enter 'RUN' 

7) When the 'READY' appears, LOAD the second program. 

6) Take the numbers from step 4 and POKE them back Into their original 
positions. The statement would be : 

POKE 16548,XXXX : POKE 16549, YYYY 
where XXXX would be the first number from step 4 and YYYY would be the second 
number from step 4. 

9) Delete lines 1 and 10001. To do this type in M 1 and hit 'ENTER 1 , then 
type In • 10001' and hit 'ENTER'. 

Your two programs have now been combined Into one. 

WARRANTY AND LICENCING AGREEMENT 

J.F. CONSULTING has made a reasonable effort to provide you with good quality 
software end documentation. However, this software and documentation Is 
distributed on an "as Is basis." 

NO OTHER WARRANTY IMPLIED OR EXPRESSED EXISTS 
However, If you should have a problem, we do desire to know what it Is. 
Please feel free to write us with any of your comments or suggestions. 
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SUWARY CF COMMANDS 

Note: "Cursor" means the fleshing mode indicator 
Regular Mode (cursor » fleshing cct> 
Arrowls) Move cursor In 

•Shift 1 end Arrow(s) 

V end Arrow(s) 
•/' end 'Shift' end Arrow(s) 
';' end 'Enter' 
'; * and 'Specebar' 
'Shift' end 'Spacebar' 

V end ' Specebar* 

'Clear' 

•/' end 'Clear' 
191 

»<• 
t.< 
1*1 



Move cursor In indicated direction. 

Drew line In ir elected direction 

Move designated figure In Indicated direction. 

Drew, with designated figure as a "pal ntbrusn", 

Save screen to r.emory. 

Load memory beck to screen. 

Load temporary suffer to screen 

Load cesignatec figure to screen. 

Clear the scre*n. 

Erase the designated figure. 

Cel I up menu of options. 

Go to Keypad Mcde. 

Go to Designate Mode. 

Go to Print Moce. 



Pr i nt Mode (cursor * 

Arrow 

Enter 

§ end Arrcw(s) 

t and 'Enter' 

•Clear' 

'Shift' and Arrow 

••" (quote) 



Any other symbol 



fleshing asterisk) 

Move cne space in indicated direction 

Go to center of current line 

Move in Indicated direction to corner cr ecce of 

screen. 

Move to center of screen 

Go to Keypad Mode 

Print picture cf arrow. 

Insert INPUT statement. 

follows quote. (If blank 

default to AS). 

Print symbol hit end move to right. 



Variable 
fol lows 



name 
quote, 



Keypad Mode (cursor ■ flashing less-than sigr) 



Graphics 
Keypad 



QW 
AS 

zx 



Arrow(s) 

•Shift' and Arrow(s) 

'/' and Arrow 
'Enter' 
t Spacebar' 
191 

• * 1 
i_i 

*.' (period) 



The keypad is cefined as the 
six letters on the left side 
of the keyboerc. 

Pressing ony letter on the graphics keypad 

will turn on the corresponding dot et the 

left of the cursor. 

Pressing 'Shift 1 and letter of graphics 

keypad will erase the corresponding dot at 

left of cursor. 

Move cursor In indicated direction. 

Drew line cf symbols like the one last entered 

with graphics keypad. 

Move entire screen In indicated direction. 

Print cursor's current coordinates. 

Drew horizontal line through cursor. 

Co l 1 up menu. 

Go to Print Moce. 

Go to Designate Mode. 

Go to Regular Mode. 
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Designate Mode (cursor 

Arrow(s) 

'Shift' end Arrow(s) 

•Enter' 



•Clear' 
191 

'<* 

'.' (period) 
Other symbols 



flashing minus sign) 

Hove cursor In Indicated direction. 

Mark location with a '+' sign and move In 

indicated direction. 

Record part of screen marked with '+' signs, 

end bring up designate, fill in, reverse, merge, 

end cancel options. 

Erase '+' signs end start again to mark off screen. 

Call up usual menu of options. 

Go to Keypad Mode. 

Go to Print Mode. 

Go to Regular Mode. 

Go to expansion module If one Is adjoined. 



Menu (celled with '9' key) 

1) Store screen In PRINT statements. Picture stored Is the one on the 
screen when the '9' key was hit. 

2) Store figure In BASIC string. The designated figure Is stored as a 
BASIC string. String that erases figure Is el so stored. 

3) Dump storage. Prepare storege for recording. Also used to load 
pictures Into GEAP, and to prepare for edjolnlng expansion modules. 

4) Magnify figure. The designated figure Is magnified by a factor of 
four (4X). 

5) Tilt figure. The designated figure Is tilted. 

6) Four views of figure. Four symmetrical views of designated figure are 
drawn. 

7) Rotete figure. The designated figure Is rotated through an angle 
entered by operator. Has magnification option. 

8) Shrlnk/Pul l-Apart figure. The designated figure Is pulled apart or 
shrunk. Two numbers ere entered, one for the X- direct I on, one for the Y- 
dlrectlon. Numbers less than one shrink figure, numbers greater than one pull 
It epert. 

9) Cancel. Return to picture. 



NOTE: Menu 



options 2, and 
See Section 3.2 



designated 

After saving stored pictures, 

2.1, step 12. 

ERROR MESSAGES 



A - 8 w! 1 1 not operate until a figure has been 
It is not necessary to relood GEAP. See section 



Message 



Section of Manual 



RECORDING . . .USING RESERVE STORAGE 
TAKING 255 BYTES OF FIGURE 
NEED MORE DATA 

STORAGE OVERFLOW 



4.2 
3.5 
3.2 
4.2 
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5.0 GEAP DISK VERSION 4BK - INTRODUCTION 

THE GEAP 48K DISK version contains all of the -features of the 
regular GEAP version plus additional disk related commands. With 
this version GEAP Expansion Modules are included and menu commands 
are incorporated to allow you to automatically load these modules. 
We will assume that you have a good understanding of the regular 
GEAP commands when reading the following documentation. 

5.1 SAVE or LOAD SCREEN IMAGE - (Command 'FG'> 

When in the designate mode, press the "F" and "G" keys at the same 
time. The following will appear: 

I -SAVE SCREEN TO DATA FILE, 2-LOAD DATA FILE TO SCREEN, 3=CANCEL 
These new commands are designed to allow you to save what is on the 
screen to a disk file, and then rapidly recall the image when you 
wish to work with it again. 

5.2 SAVE SCREEN TO DATA FILE 

If you choose selection number 1, "SAVE SCREEN TO DATA FILE", the 
next thing that will happen is that a line of numbers will decend 
on the left side of the screen. You will then be asked to "ENTER 
THE NUMBER OF LINES TO BE SAVED". Choose a number between 1 and 16 
and then press <ENTER>. The next question that will be asked is 
"ENTER FILE NAME". This can be any standard TRSDOS file name. An 
example filename would bet DRAWING1 

Please refer to your TRSDOS manual if you need to know more details 
on file names. If you tb a beginner, simply remember to use a 
name that is 8 letters or shorter. 

After you have typed in a filename, press enter. "SAVING FILE" 
will appear and you will then be returned to the designate mode. 

5.3 LOAD DATA FILE TD SCREEN 

With this command, a previously saved file using the SAVE DATA FILE 
option above can be loaded to the screen. If you have a drawing on 
the screen that you do not want to lose, either save it first in 
the permanent storage area (see regular mode command ';* and 
< ENTER >) , or save it to a disk file as described above. 

When in the designate mode, press the "F" and "G" keys at the same 
time. Choose option 2. You will be asked to "ENTER FILE NAME TO 
BE LOADED". Type in the name of the file you wish to load and 
press <ENTER>. The screen will then be filled with the contents of 
the file and you will be returned to the designate mode. 
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5.4 CALL UP PRIMARY MENU SELECTIONS - (Command '10') 

When in the designate mode, press the "I" and "0" keys at the same 
time. A menu with 9 options will appear. Before you start making 
selections, read the instructions -for each selection so you don't 
get yourself in trouble. For right now, Just remember command 
number 8, "RETURN TO BASIC". Remember that GEAP resets some of the 
internal parameters in memory when it is run. If you just press 
the BREAK key and then try to run another basic program or run GEAP 
without going to DOS READY, you may not like the results. When you 
exit from GEAP using selection B, we return everything to normal so 
you don't have to reboot your system before running other programs. 

Before going further, read "GEAP OPTIONAL EXPANSION MODULES, 
INTRODUCTION AND IMPORTANT NOTES". 



6.0 GEAP OPTIONAL EXPANSION MODULES 
INTRODUCTION AND IMPORTANT NOTES 

Before attempting to use GEAP Expansion Modules, we strongly 
suggest that you familiarize yourself with the regular GEAP 
commands. We are assuming that you have a good basic understanding 
of the regular GEAP commands when reading the following 
instructions. 

The following information is important for you to read so you will 
be aware of what you can and cannot do with GEAP expansion modules. 
You will, find that we have planned for much future flexibility. We 
have, however, a few rules that must be followed. 

OVERVIEW OF EXPANSION MODULE DESIGN 

GEAP Expansion Modules are designed to be loaded as needed. We use 
the expansion module idea so that we can add an unlimited number of 
commands to GEAP without worry of running out of memory. The 
expansion modules all load intD the same place, and therefore, only 
one module can be in place at a time. 

To conserve memory, several "common," shared memory areas are used 
in GEAP. One example of a common area is the area where the Basic 
program that GEAP has written is stored. When you use option 
1, "STORE SCREEN ON PRINT STATEMENTS", the area where your program 
is stored is in a common area. When loading a picture for 
re— editing, the program you are loading uses this common area. - If 
you load a program when the "READY FOR RECORDING" message is 
present, the program loads into a common area. Using program 
option 2 STORE SCREEN IN BASIC STRINGS, also uses the common area. 

An example of how you can get into trouble would be the following: 
(When following this example, be sure that you are not working with 
any drawing that is of value to you.) When in the "Regular* mode, 
press '9* and call up the menu of options. Select GEAP option 1, 
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STORE SCREEN ON PRINT STATEMENTS. When -Finished, choose option 3, 
DUMP STORAGE. When "READY FOR RECORDING' appears, type LIST. You 
Hill see the program that GEAP wrote. Now if you load another 
program -for re-editing, and then type LIST, you will notice that 
the -first program is gone -forever. This is because the' "common 
area" is used. 

Getting back to the expansion module, caution must be used since, 
when an expansion module is loaded, it ocupies the common area 
until it is in place. If you use GEAP to write a BASIC program for 
you, be sure to save it onto disk or cassette before changing 
expansion modules. After the expansion module is in place, this 
common area is then available for programs written by GEAP. 

Remember that until your drawing is on disk, or cassette, it is not 
safe. The all-mighty, indiscriminate power outage, or surge can 
strike at any time, so it is a good idea to periodically save your 
creations. Have fun with your GEAP EXPANSION MODULES, but remember 
the following: 

1. Save programs which GEAP has created before loading new 
expansion modules. 

2. Periodically save your drawings to tape or disk. 

6.1 EXPANSION MODULE LOADING 

All of GEAP's Expansion Modules load in the same manner. To load an 
expansion module do the following: 

1 ) Load and RUN GEAP as usual . 

2) When the flashing dot appears go to the designate mode and then 
press "I" and "0" at the same time. 

3) Select the EXPANSION MODULE you wish to run by selecting the 
appropriate number. 

4) After the module has loaded follow the instructions for the 
module you have just loaded. 

7.0 EXPANSION MODULE 1 

When Expansion Module 1 is in place, three new commands are 

available in the designate mode. Be sure to "play" with them 

before doing any serious work. When improperly used, they can 
destroy a drawing. 

EXPANSION MODULE 1 - DESIGNATE MODE COMMANDS 

•X* Exchange long term and temporary storage contents. 

"5* New designate, reverse, fill in and merge options. 

*M* "Macro" magnification and rotation routine. 
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7.1 EXCHANGE LDNG TERM AND TEMPORARY STORAGE AREAS 
(COMMAND 'X') 

When you hit the *X* key the contents of the long term and 
temporary storage areas are exchanged. This command Is handy when 
you want to merge two drawings and have to reposition both of them 
before you merge them. First, you reposition the drawing which is 
in the temporary buffer (by going to the keypad mode and using the 
*/* key and the arrows). Then you exchange the buffers and 
reposition the drawing which has moved into the temporary buffer. 
Then you merge them as usual . 

A note of caution. It's easy to forget that a drawing on the 
screen is not necessarily stored in the temporary buffer. Be sure 
you actually have drawings in both buffers before using the 'X* 

command. 



7.2 AUTOMATIC DESIGNATION OF FIGURE (COMMAND 'S') 

The purpose of this command is to save you the trouble of marking 
the screen with •♦• signs. When you press the *S* key, the 
computer "marks off" al 1 non-blank characters on the screen and 
brings up the designate, fill in, reverse, merge and cancel menu. 

This allows you to quickly designate a figure. Just draw the 
figure on an otherwise blank screen. The go to the designate mode 
and press *S.' You will see a line moving across the top of the 
screen as the computer "marks off" your figure. When the menu 
appears, choose option 1 and you're done. Of course, the figure 
still has to be small enough to take up less than 256 bytes of 
storage space. 

The *S* command is also handy if you want to merge every non-blank 
character on the screen with the drawing stored in the long term 
buffer. Just press '5' and then choose menu option 4, as usual. 

The "Reverse and Fill In" options are a little tricky. At first 
you might think that the reverse option would always give you a 
blank screen. If only the non-blank characters are reversed, why 
isn't the entire picture made blank? Well, there is a difference 
between a non-blank graphics character and a non-blank graphics 
dot. Each non— blank graphics character has from 1 to 6 lit dots or 
pixels. (You see this when you use the graphics keypad* to 
construct a graphics character.) When you press the *S" key and 
choose the Reverse option, two things happen: (1) All characters 
which were blank in all six of their pixels are still blank: but 
(2) All characters which had at least one lit pixel are reversed, 
the blank pixels are lit and the lit pixels are blanked. (Letters 
and other non-graphics symbols are left alone.) 

You will probably have to experiment for awhile before you will be 
able to predict the outcome of a "Reverse" or "Fill In" command 
preceded by the "5* command. If you are in doubt, it's best to 
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mark off the screen yourself with •+* signs rather than use the 
'S' command. 

7.3 rJASNIFY/ROTATE/SHRINK (C0W1AND 'M') 

This command works with graphics characters only. Numbers, letters 
and other non— graphics symbols will be erased. 

This command allows you to rotate the picture on the screen by an 
angle between and 360 degrees. At the same time you may magni-Fy 
the picture by a factor of 1 to 9. There is also a shrink option. 

The picture does not have to be within the 255 byte limit on 
designated figures; it may be quite large. There is, however, a 
limit on the complexity of the picture so be sure to save any 
important pictures in case you don't like the results. 

When you press the 'ft' key you will see a line descending on the 
left as the screen contents *rm recorded. If the line stops before 
it reaches the bottom of the screen, then the buffer is full and 
the remainder of the screen will not be recorded. There is, then, 
a slight pause while the center of the drawing is calculated. 

Next the menu will appear: 1=EHRINK 2-ROTATE/MAGNIFY 3-CANCEL 

If you choose option 2, you will first be asked for an angle of 
rotation. The important angles are: 

degrees Straight up and down, no rotation. 

90 degrees Picture sideways, to the right. 

1BO degrees. .. .Picture will be upside down. 
270 degrees. .. .Picture sideways, pointing left. 

Other angles can be used, but the accuracy of the results depend on 
the figure and the amount of magnification. (Distortion may occur 
due to the fact that the TRS-BO graphics pixels are about 2.3 times 
as high as they Arm long: it's impossible to slice a pixel in 
half.) 

After you enter the rotation angle, you are asked for the 
magnifying factor, between 1 and 9. A factor of 1 results in no 
magnification. 

After the figure has been drawn you will be asked if you want to 
redraw the figure. Hit 'Y* for yes and *N' for no. 

If you try a magnifying factor so large that the figure won't fit 
on the screen, the computer will only draw the part of the figure 
that will fit on the screen. When it comes to a part that won't 
fit, it will flash a *+* sign in the upper right corner. 
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9.0 LETTER SETS - EXPANSION MODULES 2 f 3, AND 4 
GENERAL INSTRUCTIONS 

When an expansion module letter set is in place, the cursor 
controls Arm the same as in the print mode. The spacebar will 
space and erase according to the size of the current letters. The 
limits o-f the screen are also rede-Fined according to the size o-f 
the letter so you won't try to print a -Figure off of the screen. 

9.1 EXPANSION MODULE 2 - MEDIUM LETTER SET 



When in the designate mode call up the menu 
"0". Select number 2 "MEDIUM LETTERS". Th« 
loaded. 



by pressing "I" and 
module will then be 



A flashing "M" will now appear as your cursor. Now when you type a 
letter, say "A", a large "A" will appear on the screen. To exit 
this mode, press the <CLEAR> key. To re-enter this mode without 
reloading this module, press the "M" key. 



9.2 EXPANSION MODULE 3 - LARGE LETTER SET 



When in the designate mode press the "I" and 
time. A menu will appear. Select number 3 
module will then be loaded. 



"0 M keys at the same 
"LARGE LETTERS". The 



The cursor will be replaced by the flashing "L". To exit this mode, 
press the <CLEAR> key. To re-enter this mode without reloading the 
expansion module, press the "L" key. 



"Shift* and Arrow prints a picture of the arrow, with one possible 
exception. In Model Ill's and some Model I's, to get down arrow, 
press "Shift*, "down arrow' and *Z' keys. 



9.3 EXPANSION MODULE 4 CUBE LETTERS 



When in the designate mode, press the "I" and "0" 
time. Now select menu item 4, "CUBE LETTERS". ThE 
load. 



keys at the same 
module will then 



The cursor will be replaced with a flashing "C* when in this mode. 

There are some additional commands which allow four different 
variations of the cubes. There is also a variation which allows 
just the face o-F the cube to be printed without the extensions. 
The commands for getting the different variants Are as follows: 



The following works like an on/off 
command to turn on a background, it 
select another background. 



switch. Once you give the 
will remain on, until you 



<SHIFT> 


+ 


"0* 


<SHIFT> 


+ 


"W 


<SHIFT> 


+ 


•A* 


<SHIFT> 


+ 


•S' 


<SHIFT> 


+ 


*N' 
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Cube background at upper left. 
Cube background at upper right. 
Cube background at loner left. 
Cube background at lower right. 
No background is printed. 

To exit this mode, press the <CLEAR> key. To re-enter this mode 
without reloading the module, press the "C" key. 

Note that the *Sr* sign is defined as a "blank". No, we're not 
trying to short change you. This letter is not commonly used (in 
our opinion), bo we made a cube for you to use to draw any symbol 
which we left out or is not a standard keyboard symbol. 

9.4 FURTHER EXPANSION MODULES 

We have included a menu into which future expansion modules can be 
inserted. Go to the Designate mode and hold dawn the "U" and "0" 
keys together. The menu will appear. 

Option 1 of the menu, "Operator enters filename of module to be 
loaded", is for loading modules you have created yourself. (See 
section 4.6 for directions on creating your own expansion modules.) 
If you choose option 1, you can enter the filename you have chosen 
for your module and the module will be loaded. 

Options 2-8 will load modules which we plan to offer in the future. 

10.0 EPSON PRINTER SUPPORT MODULE - INTRODUCTION 

The Epson printer support module is designed to allow you to use 
the features that the Epson MX-BO has in combination with GEAP. 
You can have emphasized, double strike, or select the various print 
size densities that Epson offers. (Epson MX-SO is a trademark of 
Epson America, Inc.) 

The program utilizes a fast machine language routine to translate 
the graphic codes into printable characters. When using this 
module, the Epson should be set to the MX-BO MODE, not the TRS-BO 
MODE. 

10.1 INSTRUCTIONS FOR EPSON PRINTER SUPPORT MODULE 

When in the designate mode press the "I" and "Q" keys at the same 
time. Select menu item 5, -EPSON MX BO PRINT MODULE". After the 
module has loaded, when in the designate mode (flashing minus 
sign), press the "P" key. 

You will then be asked if you want to CHANGE CURRENT PRINTER MODE. 
If you answer no, the printer will remain in the mode that it was 
last in or if you have just powered up, it will be in its power up 
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state. (The exception to this is the 40 character per line option, 
this must be specified the first time the module ha3 been loaded.) 

If you select CHANGE CURRENT PRINTER MODE, you will then be asked 
to select how many characters per line you wish. Select a number. 
(Note that if you choose the 40 characters per line, only the first 
40 characters starting from the left side of the screen will be 
printed. > 

Next you will be given options for emphasized and double strike 
print. If you choose the 16.5 characters per line mode, the 
emphasized mode will not be offered since it Is not allowed with 
the MX-BO. 

The next question will be how many lines of the screen you wish to 
print, starting from the top. This option allows you to create a 
continuous printout without unnecessary lines using several screen 
images. 

Finally you will be asked to ready your printer. After you have 
positioned the paper, press <Enter>. When finished you will be 
returned to the designate mode. 

11.0 NEWSCRIPT MODULE INSTRUCTIONS 

The Newscript expansion module is automatically included with the 
GEAP 48K disk version. To use this module, you should have the 
Newscript 6.2 or better update available from Prosoft. (Copyright 
Micro— Systems Software, Inc.) 

The Newscript module will create a file that is ready for printing 
with Newscript. The "format off" command command will be inserted 
at the beginning of the file and the "format on" command will be 
inserted at the end of the file. In addition, the "translate" 
command for the MX— SO may be optionally added to the beginning of 
the file. (This allows printing of standard TRS-80 graphics within 
Newscript. ) 

Commands arm included to load back onto the screen a file created 
as described above. When this function is used, the "dot" commands 
inserted automatically will be ignored when loading the file from 
disk. 



11.1 INSTRUCTIONS FOR USING THE NEWSCRIPT MODULE 

First load the module by pressing "I" and "0" when in the designate 
mode. Select menu item 6, "LOAD/SAVE NEWSCRIPT COMPATIBLE FILE". 
After the module has loaded the following will appear: 

1=SAVE SCREEN TO DISK FILE 2-L0AD DISK FILE TO SCREEN, 3=CANCEL 
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SELECTION NUMBER 1, SAVE SCREEN TO DISK FILE 

When this option is chosen, the first thing that will happen is 
that a row of numbers will appear on the left side Df the screen. 
You will be asked to "ENTER THE NUMBER OF LINES TO BE SAVED". Type 
In a number between 1 and 16, and then press <ENTER>. Next to be 
asked is, '"ADD EPSON TRANSLATE CODE <Y/N)". If using an EPSON 
printer, answer "Y" for yes. 

Now appearing will be "ENTER NAME OF FILE TO BE SAVED". Any 
standard TRSDOS file name is acceptable. After the file has been 
saved, the designate mode will return. 

SELECTION NUMBER 2, LOAD DISK FILE TO SCREEN 

When this selection is chosen, a file created under menu item 
number 1 will be loaded onto the screen. Be sure that that there 
Are no valuable drawings on the screen when using this option. 

When selecting option 2, you will be asked to "ENTER FILENAME TO BE 
LOADED". Type in the name of an existing file and press <ENTER>. 
The contents of the file will be loaded to the screen. 

You may also load a section of a file created with Newscript into 
BEAP. When a file is loaded with the GEAP - Newscript Module, each 
line is looked at until a H .CM GEAP" is located. When this is 
encountered, the next 16 lines following the ".CM GEAP" will be 
placed on the screen. If a ".CM END" is found, the loading process 
ends. 

Note that only the first 64 characters of the line will be loaded 
onto the GEAP screen. 

Once module is "in place," press *S* to access the Newscript Module 
commands. 

11.2 SWITCHING BETWEEN NEWSCRIPT and GEAP 

If planning to switch between NEWSCRIPT and GEAP, the following 
sequence should be used: 

1) Insert the Newscript disk. When in "DOS READY", type "NS". 

2) Now you will be able to run either GEAP or any of Newscript' s 
functions by selecting the appropriate menu item. 

If you wish to go to any of Newscript's functions when using GEAP, 
press the "I" and "0" keys at the sane time to bring up the menu. 
Now choose selection 7, "RUN NEWSCRIPT". If step number 1 isn't 
completed first, Newscript will not function. 
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11.3 NOTES ON USING NEWSCRIPT WITH GEAP 

Once you have created a Newscript— GEAP compatable -file, you may da 
a myriad of things with it. Newscript's editor may be used to 
re-edit a GEAP created -file, and/or you can used Newscript's 
printing -facilities to print this -file. Just treat the graphics 
-File created with GEAP as a Newscript -file. 

GEAP'S SCREEN FORMAT vs NEWSCRIPT'S SCREEN FORMAT 

The -first thing to realize, is that GEAP'S screen -format is, at 
this time, 64 characters across. Newscript's screen format allows 
up to 240 characters across. It is possible to move a GEAP created 
drawing anywhere within this 240 character boundary, however, when 
reloading a picture into GEAP -for re-editing, only the first 64 
characters of a line can be loaded onto the screen. 

The second important thing to remember is: Newscript's viewing 

"window" is only 60 characters across. If you load a GEAP created 

file into the Newscript editor, only the first 60 characters will 

be seen. If you wish to see the last 64, you will have to use 

Newscript's "view" command. To do this, type: V 4,64 

Some commands to review, associated with graphics in Newscript, 

are: 

Format on, -format off, translate, break, and join. To include a 

GEAP file within a Newscript file review the "IMBED" command and 

the "GET" file command. 

All the other powerful Newscript commands may be used. However 
when dealing with graphic characters, you will find that some of 
the commands (as centering) should be used with caution. Be 
cautious with the INSERT command since the automatic word wrap 
around may break up your -precious drawing. 



OKI DATA MICROLINE PRINTER SUPPORT MODULE 

The Okidata Microline BO printer module is designed to allow the 
user to print GEAP creations. The module is relatively simple to 
use. When using it, -follow the rules you would normally follow 
■for any other GEAP Expansion Module. 

To load this module, go to the designate mode, press the 'U' and 
'0' keys at the same time. Next, select menu option 4, Okidata 
printer module. The module will then be loaded. 

Whenever you wish to print something, press the 'P' key when in 
the designate mode. This module prints whatever is currently on 
the screen. After you press the "P" key you will he asked if you 
wish to change the current printer mode. This option allows you 
to change the various modes the Okidata Microline printer such as 
characters/line and lines per inch. Just answer the questions as 
they appear by selecting the approprate number. 

The name of the Okidata Expansion Module on your disk is 
EXPM0DP2. If you need more space on your disk, you may wish to 
delete the EPSON printer Module from your working disk (Be sure 
to keep it on your master disk in case you ever decide to buy an 
Epson). The name of the EPSON expansion module is EXPM0DP1. To 
delete this you would go to DOS READY and then type KILL 
■■EXPMODPl" 

NEWSCRIPT PANEL JOINER by PRO50FT 

By special arrangement with Prosoft, we have been able to include 
on your disk a program called JOINER. (Disk program name is 
"JOIN" ) Joiner allows you to combine several screen panels 
together to make a screen up to 255 characters across. For most 
of you graphic purposes, a screen format of 64 characters should 
be adequate, but in special cases, you will want to use the 
capabilities of Joiner. 

One example of where you might want to use this program would be 
the following! Say you wanted to print in the condensed character 
mode (128 characters/line). The screen format of GEAP is 64 
characters wide, so what do you do? You would then want to use 
Joiner. To create a screen format which is 128 characters wide, 
you would first create the left side and then save the file to 
disk using the designate 'FG' command. Next you would create the 
second half and do the same. Now call up the menu by pressing 
'I- and *0' at the same time, and select exit to basic. Now type 
RUN "JOIN" and press <ENTER>. The Joiner program will then run. 
Instructions for its use are included in the program. The 
resultant file that Joiner creates can then be loaded into 
NewScripts editing facilities Just as any regular Newscript file. 
(You may wish to review Newscripts GET, IMBED, and VIEW 
commands). Remember that the file that Joiner creates cannot be 
loaded back into GEAP if it is greater than 64 characters, so 
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keep your original -file intact until you are sure your edit is 
compl ete. 

After you have "played" with JOINER, you will see the advantages 
of this method. Using a -floor "tile" concept, you will be able 
to experiment with various placements o-f graphics panels without 
destroying your original. Since the files are on disk you may 
also wish to create a library of tiles and catalogue them for 
inclusion in other creations. 
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SUMMARY OF COMMANDS 

Note: "Cursor" means the flashing mode Indicator 
Regular Mode (cursor ■ flashing dot) 

In 



ArrcwCs) 
Shlfr' end Arrow(s) 
/' and Arrow(s) 
/' end 'Shirt' and Arrow(s) 
;* end 'Enter 1 
;* end 'Spacebar' 
Shift* end 'Specebar' 
/' end 'Speceber' 
Cleer* 

/' end 'Cleer' 
9' 

:<■ 
.t 



Move cursor In Indicated direction. 

Drew line In Indicated direction 

Move; designated figure In Indicated direction. 

Drew, with designated figure as a "paintbrush". 

Save screen to memory. 

Load memory back to screen. 

Load temporary buffer to screen 

Load designated figure to screen. 

Clear the screen. 

Erese the designated figure. 

Call up menu of options. 

Go to Keypad Mode. 

Go to Designate Mode. 

Go to Print Mode. 



Print Mode (cursor 

Arrow 

Enter 

t end Arrow(s) 



€ end 'Enter' 
'Clear' 

'Shift' end Arrow 
tttt (quote) 



Any other symbol 



fleshing asterisk) 

Move one space In Indicated direction 

Go to center of current line 

Move In Indicated direction to corner or edge of 

screen. 

Move to center of screen 

Go to Keypad Mode 

Print picture of arrow. 

Insert INPUT statement. Variable name 

follows quote. (If blank follows quote, 

default to AS). 

Print symbol hit and move to right. 



Keypad Mod e (cursor * flashing less-than sign) 



Graphics QW 

Keypad AS 

ZX 



Arrow(s) 

'Shift' and Arrow(s) 

'/* end Arrow 

•Enter' 

'Spacebar' 
i gt 

f_i 

».» (period) 



The keypad is defined es the 
six letters on the left side 
of the keyboard. 

Pressing eny letter on the graphics keypad 

will turn on the corresponding dot at the 

left of the cursor. 

Pressing 'Shift' and letter of graphics 

keypad will erase the corresponding dot at 

left of cursor. 

Move cursor In Indicated direction. 

Draw line of symbols like the one last entered 

with graphics keypad. 

Move entire screen In Indicated direction. 

Print cursor's current coordlnetes. 

Draw horizontal line through cursor. 

Cat I up menu. 

Go to Print Mode. 

Go to Designate Mode. 

Go to Regular Mode. 



Graphics Editor and Programmer Instruction Manual (GEAP) 



Designate Mode < cursor 

Arrow(s) 

•Shift* and Arrow (s) 

'Enter' 



'Clear* 
191 

'<» 
i«i 

*.' (period) 
Other symbols 



flashing minus sign) 

Move cursor In Indicated direction. 

Hark location with a *+' sign and move In 

Indicated direction. 

Record part cf screen marked with '+' signs, 

and bring up designate, fill In, reverse, merge, 

end cancel options. 

Erase •+' signs and start again to mark off screen. 

Cal I up usual menu of options. 

Go to Keypad Mode. 

Go to Print Mode. 

Go to Regular Mode. 

Go to expansion module If one Is adjoined. 



Menu (called with »9» key) 

1) Store screen In PRINT statements. Picture stored Is the one on the 
screen when the '9* key was hit. 

2) Store figure In BASIC string. The designated figure Is stored as a 
BASIC string. String that erases figure Is also stored. 

3) Dump storage. Prepare storage for recording. Also used to load 
pictures Into GEAP, and to prepare for adjoining expansion modules. 

4) Magnify figure. The designated figure Is magnified by a factor of 
four UX). 

5) Tilt figure. The designated figure is tilted. 

6) Four views of figure. Four syrcnetrical views of designated figure are 
drawn. 

7) Rotate figure. The designated figure Is rotated through an angle 
entered by operator. Has magnification option. 

8) Shrink/Pul l-Apart figure. The designated figure Is pulled apart or 
shrunk. Two numbers are entered, one f;r the X-dl recti on, one for the Y- 
dlrectlon. Numbers less than one shrink figure, numbers greater than one pull 
It apart. 

9) Cancel. Return to picture. 



NOTE: Menu 



options 2, and 
See Section 3.2 



4 - 8 will not operate until a figure has been 



designated, 

After saving stored pictures. It Is not necessary to reload GEAP. 

2.1, step 12. 



See section 



ERROR MESSAGES 



Message 



Section of Manual 



RECORDING . . .USING RESERVE STORAGE 
TAKING 255 BYTES OF FIGURE 
NEED MORE DATA 
STORAGE OVERFLOW 



4.2 
3.5 
3.2 
4.2 



SUMMARY OF COMMANDS 
GEAP 43K DISK USERS 



GENERAL COMMANDS 

(These Commands are always "in residence" ). 

"F* and *G* Calls up Save or Load Screen 

Image Command in Designate Mode 

* I* and "0* Calls Up Menu with miscellaneous 

commands and Expansion Module: 
1-5 options 

*U* and *0' Calls up Menu to load User- 
Created Modules 



(The commands listed below are "transient" commands. They an 
available -from the Designate Mode after the specific module is 
loaded or "in place." The commands will not -function if thf 
module has not been loaded). 

EXPANSION MODULE 1 

"X* Exchange long, term and temporary 

storage contents 
"S" New designate, reverse, fill in 

and merge option 
*M* . . "Macro" magnification and 

rotation routine 

EXPANSION MODULE 2 - Medium Letter Set 

*H" So to Expansion Module 2 

<CLEAR> Exit mode 



EXPANSION MDDULE 3 - Large Letter Set 

*L* Go to Expansion Module 3 

<CLEAR> Exit Mode 



EXPANSION MODULE 4 - Cube Letter Set 

"C* Go to Expansion Module 4 

<CLEAR> Exit Mode 



